home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / keyb / prokez14.zip / PRO-KEYS.DOC < prev    next >
Text File  |  1994-05-02  |  8KB  |  241 lines
  1.  
  2.                                PRO-KEYS Version 1.4
  3.  
  4.                       Copyright (c) 1993 by Randy S. Gregory
  5.                                All Rights Reserved.
  6.  
  7.                       ──────────────────────────────────────
  8.  
  9.                   This copy of PRO-KEYS is unregistered Shareware.
  10.  
  11.               To obtain a registered copy of PRO-KEYS send $19.95 to:
  12.  
  13.                               Mr. Randy S. Gregory
  14.                               1717 Simpson St. #217
  15.                               Madison, Wisconsin 53713
  16.                               U.S.A.
  17.  
  18.  
  19. INSTALLATION
  20. ────────────
  21.  
  22.   PROKEZ14.ZIP contents:
  23.  
  24.     1.) PRO-KEYS.EXE - Main program.
  25.     2.) PRO-KEYS.DOC - Documentation.
  26.     3.) PRO-KEYS.CFG - Configuration file.
  27.     4.) PRO-KEY2.EXE - Support file, must reside in the same directory as
  28.                        the main program PRO-KEYS.EXE.
  29.     5.) FILE_ID.DIZ  - Dizcription file.
  30.  
  31.   Suggested installation:
  32.  
  33.     1.) If you are using a previous version of PRO-KEYS first backup your
  34.         PRO-KEYS.CFG file.
  35.     2.) Remove other installed command line utilities (including older versions
  36.         of PRO-KEYS).
  37.     3.) Make a PRO-KEYS subdirectory.
  38.     4.) Unzip PROKEZ14.ZIP into the PRO-KEYS subdirectory.
  39.     5.) Add the statement C:\PRO-KEYS\PRO-KEYS to your autoexec.bat file.
  40.     6.) Reboot.
  41.  
  42.   PRO-KEYS uses approximately 5K of memory.
  43.  
  44.   PRO-KEYS uses time-slicing techniques so CPU cycles aren't wasted under
  45.    multitasking Operating Systems.
  46.  
  47.  
  48. COMMAND SUMMARY
  49. ───────────────
  50.  
  51.   <Up Arrow> and <Down Arrow> cycle through the command history.
  52.  
  53.   <Left Arrow> and <Right Arrow> move left and right within the command line.
  54.  
  55.   <Insert> toggles between insert (the default) and overwrite modes.
  56.  
  57.   <F1> displays the list of current function key assignments.
  58.  
  59.   <F2>..<F12> User definable function keys.  Defined in PRO-KEYS.CFG.
  60.  
  61.   <Esc> clears the command line.
  62.  
  63.   <Home> moves to the beginning of the command line.
  64.  
  65.   <[> or <End> moves to the end of the command line.  The left bracket
  66.    character has been moved to <Alt-[>.
  67.  
  68.   <`> searches the command history for the current command line.  Displays
  69.    the ten most frequently used matches.  Pressing <0>..<9> brings the selected
  70.    history item to the command line.  The accent mark has been moved to <Alt-`>.
  71.  
  72.   Pressing a function key applies that keys function to the current
  73.    command line.  A function key may also be used alone.
  74.  
  75.   Typing a space at the beginning of the command line disables command line
  76.    completion until <Enter> or <Esc> is typed.
  77.  
  78.   After auto-completion, <Enter> on a valid directory moves to that directory.
  79.    <Enter> on a non .EXE, .BAT, or .COM file auto-edits that file.
  80.  
  81.   <Tab> immediately attempts to complete a command.  If the command has
  82.    already been completed, <Tab> cycles through other possible completions.
  83.  
  84.   <Shift-Tab> back tracks through the last ten completions.  Handy if you
  85.    mistakenly hit <Tab> to many times.
  86.  
  87.   <Alt-C> cycles through command line text colors.  The current text color
  88.    is also defined in PRO-KEYS.CFG under "CmdColor".
  89.  
  90.   The following search order is used for completions:
  91.  
  92.        1.) The history buffer.
  93.        2.) The default directory.
  94.        3.) The directories on the path.
  95.  
  96.  
  97. USAGE EXAMPLES
  98. ──────────────
  99.  
  100. Example 1:
  101.  
  102.       user types : <m>
  103.         response : myfile.dat      [C:\]
  104.       user types : <F3>       (assigned the DOS TYPE command in PRO-KEYS.CFG)
  105.         response : type c:\myfile.dat      (C:\MYFILE.DAT is typed.)
  106.  
  107. Example 2:
  108.  
  109.       user types : <g>
  110.         response : goodies\     [C:\]
  111.       user types : <Enter>
  112.         response : C:\GOODIES>      (C:\GOODIES is made the default directory.)
  113.  
  114. Example 3:
  115.  
  116.       user types : <y>
  117.         response : yourfile.dat    [C:\]
  118.       user types : <Enter>
  119.         response : qe c:\yourfile.dat    (auto-edits C:\YOURFILE.DAT using the
  120.                                           editor specified in PRO-KEYS.CFG)
  121.  
  122. Example 4:
  123.  
  124. Adding an exclamation point <!> to the beginning of a function key definition
  125. in PRO-KEYS.CFG will cause a verification message to be presented each time that
  126. function key is pressed.
  127.  
  128.       F8 =!del
  129.  
  130.       user types : <a>
  131.         response : afile.dat      [C:\]
  132.       user types : <F8>
  133.         response : del c:\afile.dat ? (y/n)
  134.       user types : <n>     (C:\AFILE.DAT is not deleted.)
  135.  
  136.  
  137. PRO-KEYS.CFG DESCRIPTION
  138. ────────────────────────
  139.  
  140. NOTE: Changes to PRO-KEYS.CFG become effective immediately.
  141.  
  142. SAMPLE PRO-KEYS.CFG
  143. ───────────────────
  144. F2       =e
  145. F3       =more < $1
  146. F4       =!print
  147. F5       =dir
  148. F6       =rename
  149. F7       =deltree
  150. F8       =!del
  151. F9       =zip
  152. F10      =unzip
  153. F11      =mode 80,25
  154. F12      =mode 80,50
  155. Editor   =e
  156. Delay    =35
  157. Beephz   =200
  158. EditBad  =yes
  159. CmdColor =14
  160. History  =200
  161. Macros=
  162. ls=dir $*
  163. rm=del $1
  164. ───────────────────
  165.  
  166. "F2-F12"
  167. Defines the function keys <F2> through <F12>.  Function key definitions may
  168. contain special macro codes.  See "Macros" below.
  169.  
  170. "Editor"
  171. Defines the editor used by the auto-edit feature described above in the
  172. Command Summary section.
  173.  
  174. "Delay"
  175. The amount of time in hundredths of a second after a keypress before
  176. auto-completion activates.  This delay is important and should be adjusted
  177. properly.  For example, if the delay is set to small, PRO-KEYS will interrupt
  178. after every keypress causing excessive delays and a cluttered command line.  If
  179. the delay is set to large, it will take an excessive amount of time before
  180. auto-completion activates.  An optimal delay setting will allow you to type at
  181. your regular speed without being interrupted, and should afford a minimal wait
  182. before auto-completion activates.
  183.  
  184. A delay setting of "disabled" disables auto-completion.  If auto-completion
  185. is disabled, completion will occur only when <Tab> is pressed.
  186.  
  187. "BeepHz"
  188. The frequency of the verification beep.
  189.  
  190. "EditBad"
  191. If defined as "yes", most failed commands are returned to the command line for
  192. editing.  If defined as "no", failed commands are not returned for editing.
  193.  
  194. "CmdColor"
  195. An integer representing the current text color of the command line.
  196. See <Alt-C> in the Command Summary section.
  197.  
  198. "History"
  199. The number of commands maintained in the history buffer (must be <= 500).
  200.  
  201. "Macros"
  202. The following are some special codes in PRO-KEYS macro definitions:
  203. $T     Separates multiple commands in a macro.
  204. $1-$9  Equivalent to %1-%9 in batch files.
  205. $*     This symbol is replaced by everything following the macro name.
  206.  
  207.  
  208. REGISTRATION
  209. ────────────
  210.  
  211. To register, send a check or money order in the amount of $19.95 to:
  212.  
  213.      Mr. Randy S. Gregory
  214.      1717 Simpson St. #217
  215.      Madison, Wisconsin 53713
  216.      U.S.A.
  217.  
  218. When registering please specify delivery method:
  219.  
  220.    1.) E-Mail : Include E-Mail address and attachment method.
  221.    2.) Mail   : Include postal address and media type (3½ or 5¼, and density).
  222.  
  223. Upon registration you will receive the latest version of PRO-KEYS, and are
  224. entitled to free PRO-KEYS updates (including new versions and maintenance
  225. releases).
  226.  
  227.  
  228. DISCLAIMER
  229. ──────────
  230.  
  231. The author of PRO-KEYS shall not be liable in the event of incidental or
  232. consequential damages in connection with, or arising out of, the use of
  233. PRO-KEYS.
  234.  
  235.  
  236. CONTACTING THE AUTHOR
  237. ─────────────────────
  238.  
  239. If you have ideas, questions, comments, or problems email.me@
  240. <RANDY@agecon.wisc.edu>
  241.